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IMPORTANT NUMBERS 

Fill in these blanks with the correct numbers, which you can obt^^in 
FROH THE APL Coordinator at your school: 

/ 

?1Y APL USER NUMBER: 

APL SYSTEM TELEPHONE flUMRER: 

TERMINAL SYSTEMS COORDINATOR TELEPHONE NUMBER: 



IF THIS BOOK IS FOUND/ PLEASE RETURN TO; 
NAP€: 

GR^E or CLASS: 
® HOME ADDRESS: 

HOME THLEPHDfE NUMBER: 
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This manual dedicated to the students and faculty of the- .Atlanta 
Public Schools* Its purpose is to introduce .the uko of Aru/560. but^ 
it should also interest the experienced user, APL/360 is ttodular in 
design, so you will find that you need learn only that portion of the 
language required for a particular application. 

The uses of APL/560 are limited only by your imagination, as you will 
soon learn. Your mastery of the language will determine your success^ 
in the use of this conputer system. 

We hope you will benefit from this book, and ve invite your 
constructive criticism. 

Thomas J. McConnell, Jr» 

Director^ Information Processing System 
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APL - HHAT I' I" 

Ri^ht nov, A i7ompxititx:,'nyd%cr is avail^bU for use by Atlanta hiqh 
^ichool «tud«rnts (and taichisrs) . It your ;^chooi Is cijviipped wi th this 
facility^ mk your At>t-Coordi nator fcL/^ pcnsissio^. to uite it, and give 
it d try. This book i« d€5«i<?n«d to explain ^Km^ b^nic fact» about 
using tltts cofsputer* It vtl I show you how to started, and you can 
it from there • You n^e^i hot have hadrary special or a^Svanccd 
•Tsathfefsatics inrt ruction — basic »tath ii pl^inty. If you have had 
Algebra or Geometry^ you're that Shiich bctti?r ott. However, no 
matter what your rsath instruction, you can ai:tualiy teach yourself 
sofcte real computer procirazsahinq vitl^ a little practice. 

[The systen used by the Atlanta schcol^ is called a reiabte 
ter;tainal sys^eei. This sseans Chat^ your connection with the actual 
ooi^puter {located in downtown Atlanta) is made fron some distance 
aw^y with a tenninal , which looks like a large typewriter. Standard 
tmpne lines carry; the connection in fact, you will use a ^ 

telephone, or Dataget, to *call" the computer and connect the 
t€|n»inal. ; ' r ■ 

■ ' ■ ' . ' ■ 

j iiecause the computer doosh*t understand English as you know it, 
you Ksust use a special language. The particular language you will use 
l3 called^ ^P^xaeo* The 4 stands for A Programing tanguage; the 360 
for_the tyjHj of cc«aputer you will be connected witht an IBM 
Sys tiwrt/360 • Vou wll 1 find that APL is similar in many wiiys to your 
ro^ular arithpetic. the..sy«sibol-l^or edition is i^ j for division, i 
etc* ICOwever, it is also different in sotne ways. 

The API* keyboard (figure 1) is d«)signed like a regular typewriter 
keyboard, r^otice that the normal alphabet keys type letters in 
usishifted (lower case) position only, and these letters are 
italicised c^pitaluz ABCDEFaBI^KLffmPQB^^ When shifted (upper 

cas4S) , the keys type only syjnbols or punctuation. The number keys are 
in the saiae position as a regular typ^riter, but the numeral 1 is 
distinguished freo ^hd letter / or 1^ » 

j Please notice especially the keys on the riglit marked' AHi^ iatton- If 
I tion) and RETURN. Also, the Otl/OTF switch is located below the I 
^Arre key. You will use these three keys often. I 

sTgFom ^-x..^- """^ ' \ 

In order to make the ^nnection between your terminal and the 
computer you ^»ust 90 through a procedure called SIGN-ON. To perform 
a sign-on: and begin a session with the computer there are certaJIn 
steps you must follow, Before trying a sign-on ask your APL- 
Coordinator for a sign-on ACCC^OST NUMBER, Read the instructicjis below 
once <?ompIetely so ^that you will have some idea of %ihat to do. Ycu 
don't have to memorize the instructions ~ just be fainiliar with 
them. Follow them exactly for your first few sign-on*8, at least 
until you get the hang of it. If you make a mistake, don^t worry ! 
you can*t hurt APL* Simply start over and try again, {see ptl's) ' 

1 . Insert paper into the terminal, -^yse whatever paper your 
APL-Coordlnator provides. ' - 

2. Sit- comfortably at the terminal with the dataset (or 
teloEdione) within reachw ^ . 

3* Turn the terminal's ON/OPP switch to ON. The switch is 
located on the right of the keyboard. 
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a» Look over on the lof t aide of the torminal (not the 
typewrit«sr p4irt — the def»k or tabic pairt) and find the 
switch marked LCL/COM. Be sure it is switched to COM. Somo 
terminals ©ay LOC instead of LCL. In local (LCL or LOC) 
your terminal is a regular typewriter! 

5. Pick up the telephone receiver on the dataset and press the 
button marked TALK, it will stay down and you will hear a 
dial ton«s, "| 

6. Dial the computer nui^er; . , If you hear a 
busy-signal or a ! click and no other response , either the 
telephone lineis are full or the computer . is DOWN (not 
available). If you hear a ringing and no answer^ again the 
con^utor is DOWN. Vr\i i«h^^ later. 

7. When the <x>mputer answers piTCf^rly^ you will hear a hioh« 
piercing ^one in the receiver* Wh«trt this happens, press the 
DATA button on top of the dataset firmly and it will light. 
You may then hang up. If the data button doesn't light at 
all, check vour telephone connections and the power line to 

. .the ^ dataset. ■ .v. , ■ 

8. When the DATA button has been pressed, the keyboard on the 
terminal will unlock r permitting you to type your sign-on. 
To do this, type a ) — ^ight parenthesis — followed by 
your account number. {Do not put a spac« between the right 
parenthesis and the number,, or between the digits of the 
number!) When through typing, press the RBtUWI key. This 
will move the type element ba<dc to' t^ aiargin, will advance 
the paper one line, ari^ at \he aame time will send the lino 
you just typed to the compute 

7 )99999 

i $• If the computer's response i.^ lilCOBREQf Sicn-'OII^ ehwA to be 
sure you typed correctly. The coitq|>uter Will hold the 
connection about 10 seconds for you to try^' 
must dial the number again. Iff the response is either 
SVHBEH in USE OX HUMBSB HOT IE SISTEH, ask your APL- 
coordinator for assistance; If the computer rmceives your 
sign-on properly V it will type out some infozmaition about 
th^ time and the date of the si^n^on^ and belowr that it %#ill 
type the name of the coo^iiter system* Note the example 
= belbw:--^' ^ ^ . , ■■--V'V r? 

}99999 ^ 
003) to. ttl. 30 OS/07/70 

:^^p 3 5 0 BXPEESS ~ - 

The infpmation on the second line above will^ varv depending on 
the time, date, and the di9n«-on account^ nunbe 

on the bottoml Xine means tHat^ the amount df l^^ are ebnnectsrd is 
au^ttaticallyi limited by the cbiqpuier. Ttils; usually varies from IS 
minuteif to one hour. If you don* t sign off before yoisir time is up, 
^ou Will automatically be signed off at the end of t±te limit. 

When all the above has bexsn accomplished you are ready to go to 
work oh 'APL. However, for future reference, here is the procedure yod 
must follow to sign off : 



1. Typ« )€rFr ^6 ptemu th0 mtvm key. Wait until thii^ com^ut«tr 
prints uocm infoni^tion;(!ii]:K)tit the tltm you %rer« con^«rc\t#^.^ 
■ «tc,' ■ f I J- . 

2* im#n the cooaputor stops p/rln ting # turn th© t^minal OK/crr 
ftWltch to OFF. 

r At this point there is sovm thing that should be stressed for all 
beginning users t the APL tenainsl system is ideal for le^t^ing 
because there is no vay^ that you can daeiaqe anything bv typing on the 
tenninal* "me %rorst that can happen is a simple error* which has no 
effect on either taralnal or coegputer * For these reason^ * u» urge 
students to go ahead and **e^periiient* «^ ^ry some net' things. It^s 
the best way to. 'learnt . ; 

riSSAGES BETWEEH USERS 

If sOTething goes wrong which you dJ not understand you can send 
a nessage to the operator tarsdnal itowntowne ' 

yovit iVPRH Any t U»E ftsa Mlmmve one space between 

When you hit the RfiTUBH key the c^B^puter respcmds after a slight 
pause with SSST /sieaning (the nessage has type< out on the 

operator tersdnalv NIii^ c^ 

You can also learn who else is usin^ AFt by typing the systen 

cosnandx:;..^^ 

vi. \- ■ ■ ■ 

you J )FOliTS 

APLx OPR OPE a Cthis is the operator) 

ooa ycA 

OOr UMC 
005 GAT 

To send a istssaga to soMone/ first find out their port nusriSMir 
(it changes each time they sign on) than type liv^ffir a spoee^ the 
port nunberr another space* and then the »ea«age. Onee y^ hit 
ranrtme the message is transaitted*: ' 

youi )kSCM ^ JS MR. JOfSKS TBKRBT 

rospoiwe !• smt" although it uy be a uhil» bofor« 
SBKT i» printed. If you 9«t iopetient and wish tocontinoa workino. 

X2yj!3^ msssags zost win be ri- 

Mived. The KPmmo» key has interrupted the OMssaae carrier and 
we nessage will m>t be received^' 

\^py ®' all, aessages between user© ia printed on a aonitor printer 
at the eoaputer^ center . Transaission of obscene jr»asegea via tele- 
processing' system is punishable under Federal and State laws by. a 
fine- or a prison sentence* or both. ' 

ipr/quTPUT . v\ 

MieD cosasKsnicating with the coeqputer # you ,»ust be able to 
dietingruiah^ who typed what* Nomally* everything y<m type (eseept 
literal input) is indeiite^ljsix spaces « Everything the costputer typea 



. bmqin with 0 ImttmMf mfwt tfi«t -imf' iSJ^awtlt^^ '/^^s^^^t^^ri 

*w.»u ^ ^ . ; ■ - . - ■ 

' (Die -wBWWsr' ^ ■ ■ ■ ■■■^^^^^^^^^^^ ; 
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you: 



(hit RETURN} 



Dyadic operations involve an operator with values on either side 
pf the operator. Dyadic use of > is, fori example, t*t 7, Thc ^ has a 
value before and after it, Mor.adic operation invQlvi=>ig an operator 
with* a value only to its right. Konadic use of * is t? . The * has 
nothing cn its left. 

Monadic iiso of : gives the reciprocal of a nuK^ber. The reciprocal 
of ^7is^/^^ (APL dofis not give fractions, but instead, gives the 
decimal equivalent of 1/17). 

you: *17 (hit RETUtLN) 

APL:0.pS8823S29^a 



DYADIC 
(clyadic=two) 

operator 

la + 15 

T t 

value value 



MONADIC 
(monadic-one) 

operator 

+ 15 

.f 

(lvalue 



There is also a monadic use for «, which you may learn from your APL 
manual. 



To write seven squared (7 ) in APL, write 7*2 rather than trying 
to type the raised number. APL has ho superscript numbers to use as 
exponents. The asterisk/ or star, is the power or exponent sign! 



you: 
APL:^9 



7*2 



(hit RETURN) 

Seven times seven (or seven squared) is forty-nine. 



you: 
APL: 27 



APL has no specific function to find the square root of a number. 
However, the square root of aJ.s the same as raising 4 to the one- 
half power, or, iri APL, 4*0.5. - 



you: 
APL* : 2 



4*. 5 



The square root of four is two. APL will also do other roots such as 
cube root, and fifth root; all^^yoii have to do is type, ins tiead of ,5, 
the decimal equivalent of the reciprocal of "the root numb 



yous 
APL: 2 



8*,333333333 



Combining several operations into one Step includes ORDER OF 
EXECUTION. In arithmetic the exponents are evaluated first, then the 
O :multipiicatiph7^nd division, a addition and subtraction. 



i f% replacement 3x fnl 

next operation 

to the left bxii) 

replacenient j 
and results ill 

} so if you forget the APL xight-to-lef t rule, you con 3d get a wrong 
answer. Look at this example: 

ORDTKARy ARITHMETIC EXECUTION 

3:1+2x1x2 

division first EO +2x1x2 — 

replacement lilt2xTx2 

iMiiltipiication ._ . ■ 
next 3+ Ej3 x2 

replacement 3+ E] x2' 

roultiplication 
rejpeated 3+ EES 

" replacement '3+ 

addition last d+H 

replacement 

and results 111 J 



ORDER OF EXECUTIONr WHAT HAPPENS HHEN 

APL does not follow this order. Regardless of o peration ^ AFL 
executes f i-om right to left , ^- 

ORDINARY ARmiMETIC EXECUTION 
3x4+7 

irultiplication ■ . • .. ^ 

first nm +7 

replacement WS\ +7 

addition ^ 

liast II223 

vm 

?:pl execution J right-to-lhpt 
right operation 

first 3x Pr»7| 



APL EXECUTION: 
right operation 



first 

replacement 

next operation 
to the left 

replacement 

next operation 
to the left 

replacement 

next operation 

replacement 
and results 



3M + 2>< ITO 
i 

3-:i + 2x B 



3+1+ RxTI 
3t + 



3v E 



EH 



Interesting^ isn't it? Well, there is a way to get the right 
answer: you may change order of execution by using parentheses* 
Whenever ( ) appear in a line of- APL, whatever is within the 
parentheses is executed first ; (Execution inside or outside of 
parentheseis always follows the riqht to lef t ^ rule; ) The final value 
fbimd within the parentheses replaces the parenthe Once all 

pafehtheseis Have been^^^e^^ continues right to left. 

3*l + 2><lx2 results in 7 when using ordinary iar executioni 
. 6 when iising To make the results 7 when using APL 

execution, use parentheses. 



(3t1)+2x1x2 
K3^1)| t2«lx2 



execute within parentheses 
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II] +2x1x2 replacement 



after ( ) ev 
execution conti 
right operation 

replacement 

next operation 
to the left 



replacement 

next operation 
results 





8 




"Factorial" is a function used iii Algit^bra/^^ ^ ^T^ factorial of five - 
is the same as 5xUk3x2x1 % factorial gf 3 is 3x2x1 ♦ In PJ9h, the 
factorial of ^ Th^ I is tnade with a V (upj^hift A ) , a 

backspace, ar deca.i point. vrThis is called " overs tr ike". 

Several other /vi^i. characters are also ma\3e by overstrikes. 

you: !3 (hit RETURN) (3x2x1) 
APL:6 

^ ... • . ■■: • ■ . • 

you; :5 (hit RETURN) ^ 

.'. .' . ".^ . ^ '\ . ■■ ^ . ■ - . 

To perform operations involving . circles , a value for pi is 
needed. The forsyla for the area of a circle is nr^ . To find 
the area of a circle with a radius of 3 inches: . Pi is 

approximately 3. 141 5926 iS and is unending .1 In APL, pi is provided by 
the monadic symbol o (upshift letter 0) ; read "pi times". Be careful 
not to confuse o with the upshift J, the letter 0, or the numeral 
zero. 

. - - 

(upshift C?) called "circle" or "pi times" 
Uupshift J) called "small circle" 
O.J letter 0 

^ ^"inanber-zBro ~ ^ 




01 (hit RETURN) 

3.1H1592654^^i._i,-" JBr— 

No >c sim is need^ This is an 

exception whdre the mult^ operator is not reiuired, and 

multiplication 

To find the area of a circle with radius 3: 

f you: 03*2 r 
APL: 28.27433388 

Since pi is a never-ending decimal, the computer approximates pi to 
ten digits. Therefore, the answer involving o is a number rather 
than a multiple of . pi. 

To find the circumferji^nce of a circle (ci!^cumfersnce» nd ) with 
diameters: ' — ^ ' 

■■.you:'^ '.■ ■ OS ■ 
APL: 18.84955592 

You may use APL to select positive whole numbers at random. By 
typing 7^9 you asking the computer to select any number between 
(and^ including) 1 and 10. It iiill responid with onia random number. 
The ? is read !?roll''. 

■■■■ you:-\- :■■ ' ?lo ^ ■ J- , , ■ ■ ^, 

APL: 8 

The computer randomly selected the number 8'^rom 1 2 3 4 5 6 7 8 9 10. 



APL: 2 

■ ^ • . ' . ." . ' ■ 

This tiir.e, the computer, ranr'maly selected the number 2, 

you: ?^QC , 

APL: 793 1 



r f 
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APL provides several un5.que -pperatios^s « Thr»y were created 
because the operations they p*=;rj^icr» are often useful in various 

.prograniSe' . -/ . . . ^ 

[6*^4 takes the next whole number greater than or equal to six 
divided by four. In other words/ T rounds up to the next whole 
number. 

you: rs^u 
APL: 2 

Six divided by four is one aind one-half. When you round up this 
number « th^ next largest whole number is two, 

ri.237 



r takes the "cei line" of a number and is employoed monadically. 

The ;ppppsifce of f is L which takes the "floors of a number r the 
next whole niunber less than or egiial to the numb the right of L , 

you: L3 .764 ' / 

- APt: 3 / ; 

: L3 



Loi 



Here you are rounding down niunbers.^ o of pi: 

3, 141592654. iiflien y^ of pi you cbme up with 3. 

■ ■■■■L"3.2t^5 .■" 

" '.■ / ■ . ■ ;•, : . ■ , V : ■ • ■ ■ ■.:r:--iv.': , . ■ ■ . 

Dyadicaliy / r takes^^^^^^ maximum of the two nijmbers on either side 

of 'It;^.- L'-takesV, tiie 'm . ■ -^'''r ' 



Seyeh is greater than four/ t^ the ^fceilirig** choses seven. 
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10 



7ru 



4l7 



10.^ L ""2.579 

'10. n ^ 



33 ■ .,■ ■ •. 

Residue « an upright bar I (upshif t takes the remainder ^f "a» 
division problem. ~ r - 

26 

' . 2U , ^ , . . : , ^ 

nr (The remainder is one). 



you 5 
APJi; 1 



4 |105 



To get the total answer and the remainder planted out: 



you: ll05*H 
APL: i26 



you: 



mio5 



LOGIC 

l^^?* ^here are ways of comparing numbers (different from 
operating on themi such as by addition , subtraction, etc.). For 
xnstancei if you wabted to kiim a was larger than or 

equ^ to variable B; yba^^^^^ 

• ■■ A^i ■■- 

- ■ B^^fl ■ ■': >•. , , , , ■ 

A^B 



A<B 



A^B 



erJc 



,<0 



n 



In each case the result was either a one or a zero. The signs 
^ 5 = * ^ > are .called logical operators (all have the s-^m<^ 
meaning as in regular math) • If the statement using them lis true, 
the result is 1 . If it is false, the result is O.One and zero are th6 
only pqsisible answers you can get from using the loqical operators • 
Notice the follov?ing examples: 



A'A 



In the next to the laist example, the. response was 5//, not a one or 
zero. This is because ypii multiplied 5 times the resul:t of A^A . Since 
/t=A produces a one, tJ^ said 5><1 , or 5 , // 

SETS OF MERS OR^^^^V^^ V // 

Assume you number 2 to several numbers, namely 3, 

5, 7, 9, and 11. Yoii can type in / / 

.■2 + 3 ■"■ ■ ( T ■ . ■ 

■ - . . . ■ 2t5.. . . .-■ \ ^ 

' "2+7 * • ■ ■ ■ ; 

•■ 9"- , ■ . , ■ ' . 

. • ; ■ 2+9 ■ ■ . . /■/ ■"■ 

■ . ■ ■, 11. ■ ./ 

'2 + 1 1:':' 

■ ■ 13. ■ , . '.• . ■ 



or you may do it all in one line and save a lot of effort* 



. 2 + 3 ^^>7 9 11- 
5 7-911 13 



This is addition using a vector * 
numbers. . 



vector is a series of 



/WHEN TYPING A VECTOR , ALWAYS PUT AT LEAST ONE SPACE BETWEEN EACH 
ELEMENT.-' ' . ■ - 

When operating with vjpictbrs the computer responds with another 
vector. 
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»is last nnb«r is S bscff^uss 6^ a Ci is negative cmeV 
is 5, Or, if you vish^ jifou nay put the vector on the left 

of'S^tlwi^roperator, ,. ■ 

3 2 1 0 '^l^B ^ 

■ OBI 6' S ' ' 



3 4 5 eti» divide pach nuaber 
0.75 1 1.25 1.5 toy 4) 



/ 



Here is ancHdier exmaplftt 

1 2 3 U*2 
1 «♦ 9 16 

Hhen a 'vector appears on bolii sides of an (^ration siern , the 
operation applies to both yii^ 




1 



The first ic^ement of the left vsctor (2)^is added to the first 
element of tlse right vector (5) fioir. the :flrst element of the 
resultant v«K:tor (7). The second elmenil^ of the le£t» vector (1) is 
ailded 1^ the second element of the ri^t vectoz:(4)' for the second 
element of the -resultant vector (5). Ichis iaipplies to vectors of any 
length. However both vectors roust be the sane length. If you try 
.to operate bo vectors of different les^fths, the cc»q^ter will tell 
■you ■■• ■ ' '■ \- ■ . - (:'■■- 

LE9GTH EBROB © 



If you get this resfipnser display each vector to see %rtiat its 
contents are. Iteassignr otx^^ in length to the othet 

■vectbif*-^ , ■ ' ■ 



l^GTH ERROE 



C contains only 3 nufll>er8 nhile A contains 4 nun^rs. H is 
' iiBpossible for the conputer to operate on these two unequ<^^ length 
vectors. Yot: teust <^ange the nunber of values in one of the 'Actors 
so that the length of one %ri 11 equal the length of the other. Theh 
the cbiBputer can ojperate on them. ^ 

c^t 7 3, • ' 

A*C . ^ ^ . ^ 

APL is not confined to working with nui&bers*. It' canralso work 
with letters, or \ alphabetic characters, which are not variables • 
These are called^ literala > 

A^^rjSHSRMAlf' 

FISHEBHAB 

c 

FOUR 

If more than one character is within the quotes, it becomes a literal 
vector . Both of these^^^ a A was 
as si<med the value of ever^ the single quotes, FISHBR MA19 . 
Every literal character must be put witnm smgxe quotes. ~~ 

To J index a literal vector (such as ^ and C) , in other words , to 
^ rearrange selected letters from their contents , type the vector name 
iA ) , a [ (left bracket) r then the nnumbe^ position of the 

first letjter, a blank r then ^^t^ and so on 

until the selection is cbmipl 

>IC3 5 5 7] 
■ ■■' ^ SEEM 

All 8 7 53 

■ FAME' ■ . ■ - .. . • . 

ERROR MESSAGES 

By now, if you've had muc^ time to use the computer terminal, you 
have probably gotten at least several different kinds of ERROR 
REPORTS (in fact i if you've been trying real hard you may have gotten 
sevon or eightl) . This is one of the great advantages of APL s if an 
error is made, the computer tells you what kind of error, not just 
the fact that it occurred* Right now, a knowledge of ^ome of the 
simple error reports may be of 'some help in your use The APL 

notation below is exactly what } the computer types out when the 
particular error. occurs. 



VA^UB ERROR 



litis happens irtien you try to use a variable with no value assigned] to 
it;.. For instance, if yoii type A^S and then type A* 8, you will get a 
^valueerrbrVwtth the little marker (a) showing the beginning letter 
\n the variable without a value. 




A 



SYNTAX ERROR 

Mhen the report Syntax Error is receivedr it indicates that the 

commaha was you h6d an 

extra p^rehtheeis^i formula; t|»^ ccns^uter replies with a Syntax 



error. 



A ,"■ ' ■ 



DOMAin ERROR 

~X£— you get a Domain Error 



operation that can • t tiUce^^^^p^ with the nii^iers you 

know that ; it is r impossible^ to take the square root of a; negative 

number (ignoring ima^ yoii try it in APL^^ t^ 

compiitei: tells ybu^ t^ : 

■ - - ■ > " ■■ . . ■ ■ 

- • DOMAIN ERROR ' 



9 •0.5 
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WRITING PROGRAMS 

Programs are written to teach the compiiter to do ;<ao8»ething It 
doesn • t already know* ; Progriuns set up steps j the computer /executes 
them exactly' as they are written, line Prograsss are useful 

when a process is, to be used oyer and over again. ' 

APL can be In one of two states or modes. ; It is always in one 
mpde/ and it can never be in both ttiodes at the same time. The 
execution mode enables the computer to /lixunediately carry out 
instructions you type in when you hit the RETUfiH key. The computer 
gives an immediate response. j ,i 

The execution mode can be changed to the definition mode by typing a 
,V "(called del, upshift G*") V followed by a name for the program you 
are creating: 1 

^AHfYNAME 

In. this state, the computer is able^ to receive instructions (as many 
lines as you like) without ex any of iJiem^ To return to 

execution mode after^ the program is complete , type another v (del) . 
The prbgriam of instructions entered by the user during defihlfTd^ 



\ 



A 



mbde can only be carried out in execution nio^« 



PROGRAM : Converting degrees in Centigrade to degrees in Fahrenheit. 
Use the fonnula: ,^ 

C«5/9 (P-32) 
To begin/ the fomula must be written in APL. 
CONVEmriONAL API. 
P-32 

ij 

5/9 5*9 

" c ■; . • . / c . 

C=5/» (f-32) - C-£*9xF-|2 

Now check carefully the order of execution ^ 



S* 9^x Epa ' " 

5f l9>cCF*32 )l next operation to the left • 

This is not right, F-! 32 should be multiplied by ^5f 9 , hot. just 
nine. Overidiiig the ordinary order of execution is necessary. 

• C-^(5*9)xF--32 
.Check order of execution again. 



% 



ir5*9l|KF-32 

5/ 9 X OTTTI 

5794 



This is the desired result. The formula is now in APL. 

Here is how' to^put it into a program: 

You type a V and toe name of 
the progriun (lib spaces ) - 

^DEGREES 



When you h£t: RETURN , indicating that you are finished with that 
ixrer t^the computer responds witti [a] meaning that it is ready to 
receiyeit^e first line Vf instructions: APL automatically n 

O lb 
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iJpw type in the formula, usin^ API. notation. 

When you hit RETURN, you are finished with line one. 
computer types 12] and waitj for lyour instructipna • 



The 



If at any time yoa realise it you 

it RETOIW, baciKcp^ and retype the rest the 

' 'ne .- : - - - : ■ - . ...... ..... j. . . .. ., 



C5] 



If you realize your mist iJce ^tJu^s you ha%^^ hit BBTURN# on the 

nex t^Mne^r^^Jjis tead^o<Uty^ 

of the line which has errtirs/ type a } and^^^^^^l^^ the line is now 
ready to be retyped cmipletely, like this z 



[23 111 

You want the program next to print the evaluation 2or c 
line ! 2 type C and RETURN. ■ V 



so for' 
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C3] 



VDEGREES 
C*(5i9)xf-32 



t2]\ C 



\ 




You. are finished with the program » ) alwl want to return to 

execution mode # Typ® 7,\and FSTURN. In other ^^ords^v begins and 
ends definition mode, i ^The computer Will ndt^ type anything in 
response!) Here is how your program looks now: , " ^ 

"^DEGREES ' 

C2] C 
C33 V 

. ■ ■ .■ ■■■■■■ . . ■ ■: ■.■ ■ . . . . ..■„ -■ ; 1 .- ■ ■ „■...■, 

Tp make the program run f first assign a value for F0 your 
ariable (C does not heed to be assigned a value because it is given 
a value, by the program) . 

F^32 (hit RETURN) 

the name of the program: > - 

DEGREES 

.IOien :.ypu hit RETURN execute using the assigned 
value for P and will print the evaluated value for C. 



Here are some examples; 
1. P^32 

0 



DEGREES 



17 



/ 




11 you uta n vector , for MViiral valMNi for you i^iit ^%/ nmtmtmX 
oootputod wiliMTi for £"1 

Horo 1ft molthor prog ojcM9l#i COftV«rrtiti9 foot 

Uit ; X be tho mwbor of Coot^ ^ict» ytwa ^tor|1i» 9^ t^orioblo^ K 

ar>r;do<Mi'^':>^ 
. youN^Oot'^tlHr 

r : TO cwii^ ri»Mind«r 
■ of tot;^<S4v4i|i<m#-^^ 

~— -i^^ 



C5] V 



iMOi«^ c ;'ntott»or - ol! ^ foot 

:.:>:iprtiit':^T:;;-''''^^^^^^^^^ 



To rtio ttio profrMt oooigii o voloo for t ood thoxi typo tho pro^rMi 



- i ' • r • . ■ .3 - v--;-^;;-::;::- ■ .■ ■ . :, . .. ■■ ■.:::]: '-^ 

ai foot oqiaoio 3 yordo» 7 foot. ; , ; 

ir roo DO »dT Fuixy nso^tsxAim, oa baos to piuas is aud neviot 

i'whitlilypM^^ 
i'ilfioioiiij^^ 

:idifforoRt;. ,^v.^^r:^t■^•■::::■:. 
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■■■■■■■■ '■' ■^'^ri-y::'--:^ ' ■ ' 

■ • : ■ ■ / ■■■■ ^ • 



: Mow ruin tiMr pvogffwi aQAin. ; : : ' 



i ' f ■ • 

. Lmt ■ _X •!»•"•:• »«c1»r of ^ 



t praeodM /.a h t tw — n ^«»cte olsMttt of tb« vMtter. 
ll!ii«!h is 10 



of X. 



APL has an operator P (the Greek letter rho) to determine the 

length of a vector, will yield the length oT^X , or the number of 

nvimbers in the vector X , 

Y^l 3 5 7 9 0 8' 

7 . ; ■ 

There are seven numbers in the. vector 7 . 
Write the program: 

' . . s;avg 

111 '/^(■i'/X)^f>X 

122 y ■ ■■ ■ ^ ■ ' ■■ ■ ^ 

.-'[■33.. 7. ■ : 



X<-19 
AVG 
35 . 25 



20 35 67 



Assume you have another vector of integers^ You do not wani 
to average it by itself but you want to find the average of al' 
elements of plus all elements of J . You could reenter a different 
value for A" if you wish, but if the vectors are long, typing in al^ 
these /numbers is a lot of trouble. APL has an easy way to do thif 
cciils^i ?3atenation. . Catenating vectors with a » (conmia) puts th< 
veetars together into one single, longer vector. 



17 29 3 0 

^.-^x.y 

2 (display Z ) 

19 20 35 _67. 17 29 30 



Now use your AVG program to average this longer vector. 



AVG 

31 



PROGRAM; 



CouTiting by two *s to a given number , 



You count by ■ two ' s by adding two to each previous number 
starting with zero. To write a program in APL this will involve 
loop , , 



Begin with zero : \ 



\ 



"Add two to .that and reassign X 



[5.] V 



The right arrow means "go to"; step ^ says "go to step 2" 

If you execute this program you will get endless numbers 

increasing by 2 each time, .To stop this program, , hit ATTN and after 

the computer types the line number, you type a right arrow (n-). Now 
you are out of the program. 

You need to have some way for this program to stop itself. When 
^ reaches a certain number, make the program stop. To do this you 
must have a conditional loop ; in other words, if ;^ iis less than a 
certain niamber,' make the loop again (make X increase by 2), 
otherwise, stop. / 

A conditional branch is made of the "go to" arrow, the condition, 
and the line number. 

^ is the number you don' t want X to be greatier than. 

^f^^.t^ie condition is true, the program will loop, otherwise the 
program will go to the very next step. 

'If {:X<N) go to (->) step 2 (2) . But the APL order requires that it 
read: go to ( -^^ ) if the -condition is true (A'<i\?) step 2 ( 2 ) . 



/ 



■A B - , c 

: " THREE COMPONENTS OF A CONDITIONAL BRANCH 

A = GO TO 

B = IF THIS IS TRUE ^ - 

C = WHERE PROGRAM IS TO GO NEXT 

EXAMPLE: (/v7>4) / lo 

^ t t t ^ , 

' A B C ^ 



\ Your program will interrupt and go immediately to line number 10 
if 'the variable sfW"' is greater than i|, where 5t will then do what is 
required by line 10 and then go ,'On from there, ALL CONDITIONAL 
BRANCHES MUST CONTAIN THESE TIIRF^E ELEMENTS. This useful feature of 
APL allows you to do something 'in the program IF a certain condition 
occurs* " ' ' ' , ^ i , ^/'V , 



( ) 



To replace Step 4 , reopen the program nameif TWOS : 

7TW0S 
C5] 

the computer does not respond with line 1 because the first four 
lines of the program named TWOS are already filled up. Instead of 
entering line five , tell the computer you want to redo line 

VTWOS 
[5] [4] 

: [4] 

the computer responds with the line number you wish to rewrite and 
*^i>/aits reentry. 

[5] V reenter execution mode. 

•. .' ■ ■ ' , ■! ■ " 

To run this program, assign ^ a numbe^^, then type the program 
name* * 

TWOS 

■ , ■ ■»♦■ : , ■ 

■ : . ■ . S ■■■■■ 

8 " 
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LIBRARIES AND USER ACCOUNT NUMBERS 

The ML system can be broken up into several different parts. 
When you sign on> you use what is called a user account number . The 
system;has_,many of tb^se account numbers , all edDove 1000. The ones 
numbered below ,1000^: /hav^ 

anyone in the system can use; You can't sign" on with one of these 
numbers? but you may "borrow'^ programs ^^^^^^^ yourself . 

Your account (or library ) number— ' the one you sign on; with — ^ 
is divided into one or more workspaces ♦ Each workspace in your 
library is like a book in a real library. It contains your store'd 
programs (or functions) , which are like chapters in the book. You can 
borrow and use a copy of any book (workspace) in your - library. ! In 

- fact > with the proper information (and permission) you can borrow 
copies of other people's books or workspaces 1 But you may only look 
,at and use one workspace at ^vaS:*^^ you have a copy of a 

'"workspace., (when you have loaded it: 'into your workspace) you may , use 




printed;^ out is /a 'list' of the names of the workspaces in ' that!'. account "' 




to s^e or use one of these workspaces , type )LOAD followed by a 
space T^and the name of the workspace . you wish to see (remember you can 
only ]isee one at a time) . Yom must spell the name exactly as it is 
shown in the )LJ5 listing, no matter how strange it may sound. The 
computer respohds with the time and date that the workspace was 
stored. You have now loaded the iworkspace. 



)LOAD 1,6 2 8 LEMSjIM 
SAVED 10.57.39 11/11/70 



WORKSPACES 

Now you would probably like to see what programs have been stored 
(or saved) in the workspace. To do this^ simply type )FA^5 and hit 
RETURN. The list that follows is the names of all the programs or 
functions within that particular workspace. They are printed in 
alphabetical order. To list the variables, type )VARS and hit 
RETURN. Again/ the list of variables is alphabetically arranged. You 

■ may have to do a little experimenting to find what some of the 
programs 'dp, but go ahead and try --^you";^ the 
way/ if you have forgotten the name of the Workspace you are in, the 
command )WSID followed by RETURN, will tell you the name of the 
workspace. If you have not loaded any workspaces , then you are in a 

; clear workspace, and the computer tells you exactly that by typino-^ 
" CLEAR ys^ .', ■ "■■v'-:^ ^- '^^v^ 

You may want to create a whole new workspace to save your program 
or programs in." To do this, first you must be in a clear workspace. 
Then> without loading anything, typiS in the programs you want stored 
in the new workspiace in the same way you ordinarily would. When ^ you 
are through, type ;);Si4 7ff^'.(^ the 
name yoU; wantr t^ workspace; to Ihave (up - to eleven letters or 

^ numerals , no sp^ 

- of your workspace V not the name of any program. Sample, workspace^ 
I: nam^BS :are^^^ respond :by 
. typing .out 'the time and rdate of storage. Your workspace is now saved, 

along with .that' prbgram ( or . function) which you. created' when you 

■ typed , the 7 *'and the •program :name. Any time you sign on with your 
account- number^ you may type ! ) LIB and ^ your workz^p ace , will be one of 
those listed. Remember, however, that -the new .workspace is stored 
only in the number you signed on with. Often ,vw6en you try to save ; 
a new ^ workspace , you will get the mess"agevV5^:^.;^^Q^^^ 

means just that: there is no room left in that number; for a new 
workspace. If this is the case, it is advisable to just use one of 

- the other workspaces in your number. If . .you need a new workspace 
'4;l;u^*gently , -call the computer center, downtown; they' can give you 
^||addi:tiQna3Mro ■ -^•.-■-v.m^ 
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PUBLIC LIBRARIES 

APL has a group of w^^spac^ with numbers below 1 000 tha^ are ^ 
there for public us^. Ifr fac=v they are called Public Librar ies. 
)LIB followed by the la^bx^arv numi^., and out comes " a list — of — tKe 
workspaces contained isn ^tft^^ Simply type 

)LIB 1 
ADVANCEDEX 

APL COURSE ' 

NEWS - — r 

PLOTFOBMAT 
TYPEDBILL 

WSFNS . 1- 

VIDEO 

MULTDBILL . " 

TRYTHIS 

LATEB , 



The^^li^raries we currently have are, numbered 1 through 5, so give 
this lisfcing a try. Loading a workspace from a public library is 
almost exactly like loading one of your own private workspaces. The 
one difference is that you Jiave to tell what library and what 
workspace you want when loading from a public library, whil^ with 
your own workspaces you need only give the name of the workspace. To 
load a public library workspace,, type )Lc?4/? fol lowed by the library 
niamber^and-^tlie~-name--Q^the-workspace-you^"^^^^ 
example: 

)LOAD 1 PLOTFOEMAT 
SAVED 09/22/68 



Most Of the workspaces in our public libraries will give you some 
kind of description of their contents if you type out /?jF5C/?Jfi£' i Even 
if they don Vt, you can list the names of the programs thisy contain by 
typing )FNS . The list that follows (in alphabetical order) is' a list 
of the programs in that workspace. It may require some experimenting 
to find what some of the programs do, but don't Uet this^ frighten 
you. Experimenting in APL is fine — especially public libraries, 
where nothing can be stored* permanently by our re^lar users. 



ERROR REPORTS 

CHARACTER ERROR 
DEFN ERROR 

DOMAIN ERROR 

LENGTH ERROR 

MESSAGE LOST 

RESEND 

SYMBOL TABLE FULL 
SYNTAX ERROR 

SYSTEM ERROR 

VALUE ERROR 

WS FULL 



SYSTEM COMMANDS^ 

)'123it5 
)OFF 

) CONTINUE 
)LOAD 
) ERASE 
)WSID 

)WSID JOBFOUn 
)SAVE 
' )SAVE WSNAME^ 



Improper symbol used re-enter line 

Incorrect attempt at function definition or 
improper use of V 

Requested operation cannot be done using the 
given values 

Vectors are net of the same length rework one 
vector 

The message you were trying tc send was never 
transmitted --re-send 

Last line entered was not received by the 
computer r- re-enter last line " 

Too many variables used v;- erase some 

Incorrect command -r re-enter line with 
corrections 

Internal problem --report these to the Terminal 
Services Coordinator along with your printout 

A; variable has not been given, any value 
assign a value to the variable 



You have no more room in your workspace load 
another one — • 



lliiiiiiiiii^^ 



■ sign on . • ■ ■ ■ 

sign off 

sign off and save your workspace 

change to a different workspace 

erase a program (function) or a variable i 

name of current workspace / 

change name of current v;orkspace to JOBFOUR 

store workspace on disk / 

store a copy of current workspace under a new or 
^ . different 'name . \ 




; \;ij.5i .any,3,naitea>tunctionS'\ .'j/n . ' . • r ' 



^^^^ list all named worksp'ace.s in your library : 

)PORTS list terminals currently signed on the system, 

by port number and identification 

)MSGJi send a one-line message to another port 

)OPRN send a one-line message to the operator at the 

computer center 

)CLEAR drop the current workspace 



I-BEAM FUNCTIONS ^ 

The I { X backspace t , spelled I-beam) followed by any of 
these numbers, will give you certain data depending on which number 
is used: 

119 Amount of time (in sixtieths of a second) that the 
keyboard has been unlocked since sign-pn 

120 Time of day (in sixtieths of a second) 

X21 * Amount of computer time used since signron (in sixtieths 

of a second) 

122 Number of bytes (or characters) remaining for rse in your 
workspace 

123 Number of terminals currently in use 

124 ■ * Time y^^ 

125 Date, given as pairs of digits forrimonth/ day and year- 07 

i27 -„ Gives a vector Of statement numbers of statemehts^^^^^ w 

any programs where execution was suspended for some 
reason. 

126 Gives the first element of the vector developed by I-beam 
i29 Gives your user account number. 
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SYflBOL CHART 

SYMBOL N'Ahffi 



FUNCTION OR MEANING 



TERMINAL ROW 

umlaut or 
diaeresis 

negative 

less than 

less than or 
equal to 

equals 

greater than 
or equal to 

greater than 

not equal 

or 

and 

minus 



division 



ONE 
not used 

monadic - designate a negative number 
dyadic— comparing numbers 
dyadic - comparing numbers 




plus 



dyadic - comparing niimbc^rs 
dyadic- comparing numbers 

dyadic - comparing numbers 

dyadic - comparing riumbers 

dyadic - logical union 

dyadic - logical intersection 

monadic- negation 
dyadic -subtraction 

monadic- reciprocal 
dyadic -division^^ 

monadic-identity , ^ 
dyadic -addition 

monadic-sign 

dyadic -multipiication 



TERMINAL ROW TWO 



rol.^ ; 

olhCi?a 

element 

rho 

not 

take 

drop 



monadic^' random numbers : 
dyadic -riandom numbers without replacement 

not used 

dyadic - logical membership ' 

monadic-dimensions 
dyadi c -reshape 

monadic- logical negation . 

dyadic - use specified elements 

dyadic delete specified ^ element s.'i,;: v/ '..:* 



iota 



monadic-consecutive integers 
dyadic -indexing of arrays 



erIc 



o 


pi tiroes 


roonadic-multiples of pi 
dyadic -trignometric functions 




exponent 


monadic-natural exponeiVt 
dyadic -power 




branch 


ixionadic-branch within a program 




assign 


dyadic - assigning values 




TPPMTNA! nnw 


irlKCC 


CI 




nor usea 


r 


1 1 1 fl t* 

wC J. X X 11 2^ 


^TKonadic^rounds up 


r 


luaXJlIfSwUIi 


dyadic -takes maximuro 


!. 


floor 


jnonadic-rounds down 




roinimuin 


dyadic -takes roiniroum 




underline 


used to underline various le^tters and characti 


V 


del 


used to change ihbdes 




delta 


trace and stop codes 


o 


small circle 


outer product 


» 


quote 


used only in pairs for literal characters 




quad 


numeric input 


( ) 


parenthesis 


used in pairs to override order of execution 
used in pairs to index : ^ ^ 


C 3 


^brackets 




TERMINAL ROW 


FOUR 


■ ■ c ' 


unriaroed 


■ riot used 




iinnamed 


not used 


n 


unnamed 


not used 


u 


unnamed 


not used 




decode 


dyadic - change to base ten 




encode^ 


^dyadic - change bases 


i|i 


"absolute 
vaiue^ 


monadic- absolute value 
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/ 



residue dyadic •remainder 

catenation 



semicolon 

decimal 

colon 

left slash 
right slash 



monadic-make a vector 
dyadic -combining vectors 

dyadic - separation 

place decimar thin a number — 

used with lock -words or line labels 

dyadic - expand arguments 

dyadic - reduce or compress 



0 V E R S T R I K E S 



SrifBOL HOH MADE 



NAME 



o backspace * logarithm 



FUNCTION OR MEANING 



monadic - natural log of a 
number 

dyadic - log of a number, any 
base 



o backspace | reversal 
rotate 



moi>adic - reverses order 
dyadic - rotates first elements 



o backspace \ transpose 



monadic t switches dimensions 
dyadic - changes designated 
dimensions of a matipix 



A backspace | grade up 



monadic - orders in ascending 
order 



V backspace \ grade down monadic - ordeirs in descending 

or^et 



7 backspace del*^tilde 



locks ^^ctions (UgB WITH CAHE I) 



n backspace o cowmant or prevents the execiAtionr allows 
lan^ for comments 



D 



• backspace 0 quote-quad requires literal input 
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» backspace . factorial monadic - evaluates factorial 
combination dyadic-evaluates a combination 



A backspace ^ nand 



nor 



V backspace 
X backspace t I*beam 



dyadic - not and 



dyadic - no c or 



monadic - various computer 
functions 



n y s T F R I I 



IF 

TRY 

WHY? 

IF 

TRY 
WHY? 

IF 

TRY 

WHY? 

IE 

TRY 

WHY? 



you gpt no response af^er entering a command 
hitting RETIIRN ^ 

the computer cannot execute untess you send the command, and 
it receives the cbiraahd^ 

you get no response and the type element is at the left 
margin 

typing a quot*; ::r 
you may be in an open quote | 



nothing happens fpr a long ti«ie 

e^teringy:d§ta|^r ; :' ■ 

^bu ■ may: ' hay e V^f orjist te^^ 



\ 



you exf cute a program and do not get any response for several 
minutes 

hitting ATTENTION, then a 

it may be in an endless loop * 
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ERIC 



•' ..'-^ "'"^y ' ''^'^-^ ii'i ' - t '-J; 




IF you dial up and get a busy signal or no answer 

TRY hanging up 

WHr? the systes is do*rn 

IF you keep getting 0 

TRY entering any number « or 



WHY? 



you are in a progran requesting nunerical input (youMl be 
out eventually) 



IF you don't understand wha^ 

TRY doing it anywayi 

WHY? youUl never learn unless you do 

I F you think you ha«re danaged the conputer because you typed 

something 

TRY again 

JOffl? yo u h a ven't hurt rn^thing — - 



IF the type elenent is at the left margin (without spacing over) 

awaiting input ^ 

TRY - typing 0 backspace U backspace f ♦ 

WHY? you are within a program requiring literal or character 
input: this will get you out 



TRY 



IF the terminal or telephone? itself is actually broken 



calling e59-3381» extension 327, and ask for the Tenninal 
Services Coordinctbr 

WHYT report all troubles to the Terminal Services -Coordinator 




We invite your comments » suggestions and criticissas^ 
whether they be bouquets or brickbats! It is; planned that 
this book Kill be revisedf within two years » so we would 
like to laake the next edition better and more useful to 
our readers^ tell us what you like or don*t like about 
this book. If catch aistakes or errors » please tell 
us tine specif Ic page » paragraph , and line. If you have 
questions that you would like answered, please be sure* to 
include your name and address. Suggestions may be 
an^inyaious if you choose. 



Address your comments to: 



Terminal Services Coordinator 
iRfbraatiba Processing System 
Atlanta Public Schools 
218 Pryor St;, S.W. 
Atlanta; Georgia 30303 



Thank you! 
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